home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / c / ppmore.doc < prev    next >
Text File  |  1996-09-07  |  6KB  |  149 lines
  1.  
  2.  
  3.                            PPMore 1.71 User Manual
  4.  
  5.                                 March 4, 1991
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.      This program is freeware, this means that you can copy it freely as long
  13. as you don't ask any more money for it than a nominal fee for copying.  If
  14. you want to distribute this program you should keep this document with it.
  15. This program cannot be used for commercial purposes without written permission
  16. from the author.
  17.      If you have suggestions or remarks about this program, or if you find
  18. any bugs, please let me know.
  19.  
  20.      Write to the following address:
  21.  
  22.                                 Nico François
  23.                                 Corbielaan 13
  24.                                 B-3060 Bertem
  25.                                 BELGIUM
  26.  
  27.  
  28. Contents
  29. ========
  30.  
  31. 1. An introduction
  32.  
  33. 2. Usage
  34.  
  35. 3. Control
  36.  
  37. 4. Using PPMore from other programs
  38.  
  39.  
  40. 1. An introduction
  41. ==================
  42.  
  43.      This program was written to complement one of my other utilities,
  44. PowerPacker (a command and data cruncher).  It is used to read normal ascii
  45. text files or text files crunched with PowerPacker.  The program itself is
  46. about 10K long and when you know you save about 60% when you crunch a text
  47. file, you can see that this could save a lot of space on your disks.
  48.      PPMore was written as a more replacement (as you could have guessed :-),
  49. so I tried to keep the keyboard commands the same as well as adding some new.
  50. There are two main differences between PPMore and More, PPMore uses gadgets
  51. and it always loads the complete file in memory (More only loads part of the
  52. file and will load the rest when needed).  If you can live with these
  53. differences, you can replace More with PPMore anywhere you want.
  54.      If you haven't got PowerPacker you are of course missing one of the main
  55. features of this program.  PowerPacker is available as shareware (up to
  56. version 2.3b) or as a commercial program (from version 3.0a).  Order a copy 
  57. from your local UGA distributor or directly from  UGA, P.O.Box 881, 3700 AW 
  58. Zeist, The Netherlands. The commercial version offers several enhancements 
  59. like 40 to 50 times faster crunching and overlay crunching.
  60.  
  61.  
  62. 2. Usage
  63. ========
  64.  
  65.      PPMore can be used in four different ways.
  66.  
  67. - First of all via the CLI:
  68.  
  69.      If you enter PPMore without arguments you will get a usage template.
  70. You use PPMore like this:
  71.  
  72.      PPMore [<options>] [<file|dir>]
  73.  
  74.      The program will then load the ascii file and display it.  If the file
  75. was crunched using PowerPacker 2.0 or higher PPMore will first decrunch it
  76. for you.  If the file was encrypted you will be prompted for the password.
  77.      The options are explained in section 4.
  78.      PPMore can be made resident so it doesn't have to be loaded every time
  79. you use it, use the ARP ARes command or the c: Resident command for this.
  80. You can't make PPMore resident when it is crunched !!  The file is supplied
  81. as an uncrunched command file with the pure bit set.
  82.      If you enter PPMore without options, you will be presented with either a
  83. file prompt or a filerequester (if arp.library or asl.library is available).
  84. Entering PPMore with a directory instead of a file as an argument will also
  85. get you a requester, but it will be positioned in the directory you specified.
  86.      Enter 'PPMore ?' for a little usage message.
  87.  
  88. - Via the WorkBench:
  89.  
  90.      There are three different ways of using PPMore via the workbench: you
  91. can set the default tool of the (crunched) text file to 'PPMore', you can
  92. single click the PPMore icon and then double click the text file icon or you
  93. can double-click the PPMore icon and enter the filename in the string gadget
  94. (or the ARP filerequester) you will be presented with.
  95.      You set the default tool by single clicking the icon of the text file
  96. and selecting 'Info' from the workbench menu.  You will get a window with
  97. several gadgets in it, click in the string gadget where it says 'Default
  98. tool' and enter ':ppmore'.  PPMore should be in the root directory of your
  99. disk for this to work, if e.g. it's in the system directory you should enter
  100. ':system/ppmore'.  Last of all select the 'Save' gadget.
  101.  
  102. NOTE: - PPMore will add '.pp' to the filename when the file wasn't found.
  103.         This is very useful in the WorkBench enviroment: you can make an
  104.         icon for 'text.doc' but name the file 'text.doc.pp'.  Now the
  105.         WorkBench will show an icon with 'text.doc' as name, but if you
  106.         doubleclick it 'text.doc.pp' will be displayed.  (As long as there
  107.         is no 'text.doc' file in the directory !)
  108.       - Once you are in PPMore press 'L' to load a new file, this is
  109.         especially useful if the arp.library is available.
  110.  
  111.  
  112. 3. Control
  113. ==========
  114.  
  115.      PPMore can be controlled by keyboard or by intuition gadgets.  To get a
  116. summary of the keyboard commands press <HELP>, the function of the gadgets
  117. shouldn't be hard to understand.
  118.      A few notes on printing:
  119.  
  120. - The printer.device has to be in the devs: directory for PPMore to be able
  121.   to print, you should also have a correct system-configuration for your
  122.   printer.
  123.  
  124. - You can continue to read the text when PPMore is printing (this IS a
  125.   multitasking computer ! :-), you can't quit when printing is still in
  126.   progress !
  127.  
  128.  
  129. 4. Using PPMore from other programs
  130. ===================================
  131.  
  132.      If you are not a programmer you can skip this section.
  133.  
  134.      PPMore has two power options to make it possible to use it from other
  135. programs.  This way you don't have to include a text displayer in your
  136. programs, you just execute PPMore with one (or all) of the following options:
  137.  
  138.      -@mem,len,flags[,name]
  139.  
  140.        If you specify this option PPMore will not load a file but instead it
  141.      will display a chunk of memory.  You specify the memory addres and
  142.      length in the command line as well as some flags.  The current version
  143.      only has one flag: PPMORE_FREEMEM = bit 0 of the flag-word = 0x1.
  144.        When this flag is set PPMore will free the memory after it has
  145.      finished, if it isn't set PPMore will just exit and leave the memory
  146.      alone.  This way your program can start PPMore with the PPMORE_FREEMEM
  147.      flag set and exit before PPMore has ended.  PPMore will then free the
  148.      memory instead of your program.
  149.